|
| 1 | +# Page 1 |
| 2 | + |
| 3 | + |
| 4 | + |
| 5 | +<figure><img src="https://easypanel.io/img/logo_light.svg" alt="" width="375"><figcaption><p>Install and Operate Lowcoder on Easypanel</p></figcaption></figure> |
| 6 | + |
| 7 | +* **Prepare Easypanel and Server Requirements** |
| 8 | + * Ensure that Easypanel is installed on your server. You can install it by following the Easypanel installation guide. |
| 9 | + * Verify that your server meets the requirements for Lowcoder, including sufficient CPU, memory, and storage.  |
| 10 | +* **Access the Docker Compose Configuration** |
| 11 | + * [Obtain the Docker Compose file for Lowcoder. This file](https://github.com/lowcoder-org/lowcoder/blob/main/deploy/docker/docker-compose-multi.yaml) defines the necessary services and dependencies. We suggest the "Multi-Image" installation. |
| 12 | +* **Set Up a New Project in Easypanel** |
| 13 | + * Log in to Easypanel and navigate to the dashboard. |
| 14 | + |
| 15 | +<figure><img src="https://raw.githubusercontent.com/lowcoder-org/lowcoder-media-assets/refs/heads/main/images/Easypanel%20|%20Service%20Compose.png" alt=""><figcaption></figcaption></figure> |
| 16 | + |
| 17 | +* Click on **Create New Project** and provide a name for the project, such as "Lowcoder." |
| 18 | +* In the project settings, select **Docker "Compose"** as the deployment type. |
| 19 | + |
| 20 | + |
| 21 | + |
| 22 | +* **Upload or Paste the Docker Compose File** |
| 23 | + * In the Docker Compose section, either upload the file or paste the contents of the Docker Compose configuration for Lowcoder after your adaptations. |
| 24 | + |
| 25 | +<figure><img src="https://raw.githubusercontent.com/lowcoder-org/lowcoder-media-assets/refs/heads/main/images/Easypanel%20|%20Docker%20Compose.png" alt=""><figcaption></figcaption></figure> |
| 26 | + |
| 27 | +* We suggest changing the values at least for: |
| 28 | + * LOWCODER\_DB\_ENCRYPTION\_PASSWORD |
| 29 | + * LOWCODER\_DB\_ENCRYPTION\_SALT |
| 30 | + * LOWCODER\_API\_KEY\_SECRET |
| 31 | + * LOWCODER\_ADMIN\_SMTP - all settings for the SMTP - eMail, so Lowcoder can send for example password-reset eMails. |
| 32 | + |
| 33 | +{% hint style="danger" %} |
| 34 | +Ensure that all environment variables required by Lowcoder (like database credentials, API keys, etc.) are correctly specified in the file. |
| 35 | +{% endhint %} |
| 36 | + |
| 37 | +* **Adapt the Port Setting of the Frontend-Container** |
| 38 | + * For the Frontend Container image, leave only the service-port. Easypanel contains the Traefik Loadbalancer, which later binds the Domain to this Container Image. |
| 39 | + |
| 40 | +``` |
| 41 | +lowcoder-frontend: |
| 42 | + image: lowcoderorg/lowcoder-ce-frontend:latest |
| 43 | + container_name: lowcoder-frontend |
| 44 | + ports: |
| 45 | + - "3000" |
| 46 | +``` |
| 47 | + |
| 48 | +{% hint style="info" %} |
| 49 | +We suggest to use named Versions for the docker image. _:latest_ works well, but can automatically use updates without your interaction. However some of the changes of Lowcoder may need your attention. We suggest to use Named Versions like 2.4.x or 2.5.x, so you can control when the installation actually update. |
| 50 | +{% endhint %} |
| 51 | + |
| 52 | +* **Start the Installation** |
| 53 | + * In Easypanel, click on **Deploy** to start the Lowcoder installation. |
| 54 | + |
| 55 | +<figure><img src="https://raw.githubusercontent.com/lowcoder-org/lowcoder-media-assets/refs/heads/main/images/Easypanel%20|%20Deploy.png" alt=""><figcaption></figcaption></figure> |
| 56 | + |
| 57 | +* Easypanel will pull the necessary Docker images, set up containers, and configure the services as per the Docker Compose file. The process should not take much more than a Minute. However, the startup and initialization of the api-service may take up to 3 minutes. |
| 58 | +* **Verify the Installation** |
| 59 | + * Check that all services are running by reviewing the container statuses in Easypanel > Deployments |
| 60 | + |
| 61 | +<figure><img src="https://raw.githubusercontent.com/lowcoder-org/lowcoder-media-assets/refs/heads/main/images/Easypanel%20|%20Deployments.png" alt=""><figcaption></figcaption></figure> |
| 62 | + |
| 63 | +* **Bind Lowcoder to a Domain** |
| 64 | + * In the "Domains" section of your Easypanel, you can edit the Binding from Domain / URL to the Frontend Container of Lowcoder. |
| 65 | + |
| 66 | +<figure><img src="https://raw.githubusercontent.com/lowcoder-org/lowcoder-media-assets/refs/heads/main/images/Easypanel%20|%20Domain%20Settings.png" alt=""><figcaption></figcaption></figure> |
| 67 | + |
| 68 | +* In the Dialogue you select the Frontend Image and the Port that you did set up in the Compose YAML. This binds Lowcoder to Port 80 HTTP - and 443 HTTPS. |
| 69 | + |
| 70 | +<figure><img src="https://raw.githubusercontent.com/lowcoder-org/lowcoder-media-assets/refs/heads/main/images/Easypanel%20|%20Domain-Binding.png" alt=""><figcaption></figcaption></figure> |
| 71 | + |
| 72 | +* **Start Using Lowcoder** |
| 73 | + * With Lowcoder successfully installed, you can start creating and deploying applications directly from the Lowcoder interface. |
| 74 | + * Easypanel will handle ongoing service management, allowing you to monitor, update, and scale Lowcoder as needed. |
0 commit comments