# Install Finmars Platform

#### Here is a Full Guide to install Finmars on your Ubuntu VM:

Complete time of full installation is less than 30 minutes, by the end of it you will get a Finmars Platform Installed on your Linux Server

<span style="white-space: pre-wrap;">Prerequisite: You need to open your Terminal and navigate to the directory that contains your key-pair (.pem file) that was created in </span>["Create VM" step of installation guide](https://docs.finmars.com/books/installation-guide-with-aws-advanced/page/create-virtual-machine)

1. **Connect to your VM**  
    Example:  
    ```
    # if this first connect 
    chmod 400 finmars-platform-vm.pem
    
    ssh -i ./finmars-platform-vm.pem ubuntu@<Public-IP>
    
    # if this first connect
    # Are you sure you want to continue connecting (yes/no/[fingerprint])? yes
    # yes
    ```
2. **Install dependencies**  
    ```bash
    sudo apt update
    sudo apt install -y ca-certificates curl gnupg lsb-release ntp make git
    
    wget -qO- https://get.docker.com/ | sh
    
    sudo usermod -aG docker $USER
    newgrp docker
    ```
    
    To check if Docker installed:  
    `<span class="editor-theme-code">docker version</span>`  
    Should output:  
    ```
    Client: Docker Engine - Community
     Version:           28.2.2
    ...
    ```
3. **Create the finmars folder**  
    ```bash
    sudo mkdir -p /opt/finmars
    sudo chown $USER:$USER /opt/finmars
    ```
4. **Clone the Finmars Platform Community Edition repository from Github**  
    See [https://github.com/finmars-platform/finmars-community-edition](https://github.com/finmars-platform/finmars-community-edition) repository  
    ```bash
    cd /opt/finmars
    git clone https://github.com/finmars-platform/finmars-community-edition.git .
    ```
5. **Install Finmars Community Edition**  
    ```f#
    make install
    ```
    
    You should see something like this as successful result[You should see something like this as successful result:  ](https://docs.finmars.com/uploads/images/gallery/2025-06/screenshot-2025-06-11-at-20-37-55.png)[![Screenshot 2025-06-11 at 20.39.07.png](https://docs.finmars.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-11-at-20-39-07.png)](https://docs.finmars.com/uploads/images/gallery/2025-06/screenshot-2025-06-11-at-20-39-07.png)
6. **Start all services**  
    ```bash
    make up
    ```

<span style="white-space: pre-wrap;">To Verify that is everything running </span>

`<span class="editor-theme-code">docker ps</span>`

And you should see something like:

[![Screenshot 2025-06-11 at 21.08.45.png](https://docs.finmars.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-11-at-21-08-45.png)](https://docs.finmars.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-11-at-21-08-45.png)

It means all the Docker Containers are running.

---

<span style="white-space: pre-wrap;">When all is done, you can Open Web Browser at </span>**finmars.example.com** and you should see **Finmars Welcome Page**

[![Screenshot 2025-06-11 at 21.11.43.png](https://docs.finmars.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-11-at-21-11-43.png)](https://docs.finmars.com/uploads/images/gallery/2025-06/screenshot-2025-06-11-at-21-11-43.png)

<span style="white-space: pre-wrap;">After you press </span>**Login**<span style="white-space: pre-wrap;"> you will be redirected to </span>**Finmars Single-Sign-On**<span style="white-space: pre-wrap;"> (SSO) to </span>**finmars-auth.example.com**

[![Screenshot 2025-06-11 at 21.18.15.png](https://docs.finmars.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-11-at-21-18-15.png)](https://docs.finmars.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-11-at-21-18-15.png)

<span style="white-space: pre-wrap;">Login with your Credentials that you provided in 6) </span>**Configure env**<span style="white-space: pre-wrap;"> step. It should be yours </span>`<span class="editor-theme-code">ADMIN_USERNAME</span>`<span style="white-space: pre-wrap;"> and </span>`<span class="editor-theme-code">ADMIN_PASSWORD</span>`

<span style="white-space: pre-wrap;">After Login you will be redirected to </span>**Dashboard page**<span style="white-space: pre-wrap;"> in </span>**Finmars Platform**

[![Screenshot 2025-06-11 at 21.52.33.png](https://docs.finmars.com/uploads/images/gallery/2025-06/scaled-1680-/screenshot-2025-06-11-at-21-52-33.png)](https://docs.finmars.com/uploads/images/gallery/2025-06/screenshot-2025-06-11-at-21-52-33.png)

<span style="white-space: pre-wrap;">Congratulations you finished your </span>**Finmars Platform**<span style="white-space: pre-wrap;"> Installation </span>**Successfully**! Well Done!  
  
<span style="white-space: pre-wrap;">Get to know our </span>[User Quick Start](https://docs.finmars.com/books/user-quick-start)<span style="white-space: pre-wrap;"> guide for next steps</span>

If you have some troubles during Installation - reach for any support channel:

- <span style="white-space: pre-wrap;">Create a </span>[Github Issue](https://github.com/finmars-platform/finmars-core/issues/new)
- <span style="white-space: pre-wrap;">Join our </span>[Discord](https://discord.gg/dJFxjwKQet)<span style="white-space: pre-wrap;"> Server</span>
- <span style="white-space: pre-wrap;">Contact us at </span><support@finmars.com>  
    <span style="white-space: pre-wrap;"></span>