2.4 KiB
title |
---|
1. Getting Started. |
Getting Started
This section details everything you need to know to get Penpot up and running in production environments. Although it can be installed in many ways, the recommended approach is using docker and docker-compose.
Install Docker
Skip this section if you already have docker installed, up and running.
Probably the best approach to install docker is following the official docker installation guide: https://docs.docker.com/engine/install/
Optionally, after installing docker, you can tweak your system for avoid constanly using of sudo. The easy, single step way is executing the following command that will add the current user to the docker group:
sudo usermod -aG docker $USER
NOTE: probably you will need to re-login again to make this change take effect.
For more advanced setup, docker already has a guide for rootless docker
Start Penpot
As first step you will need to obtain the docker-compose.yaml
file. You can create it from scratch or start with the default
one from penpot repository:
wget https://raw.githubusercontent.com/penpot/penpot/main/docker/images/docker-compose.yaml
wget https://raw.githubusercontent.com/penpot/penpot/main/docker/images/config.env
The configuration is defined using environment variables in the
config.env
file and the downloaded file already comes with the
essential variables already set and other commented with appropriate
comments.
docker-compose -p penpot -f docker-compose.yaml up -d
This will start listening on http://localhost:9001
Configuration
If you started the application without configuring SMTP, you probably need to create a user in order be able login into the application. You can create an additional, already activated user using this command:
docker exec -ti penpot_penpot-backend_1 ./manage.sh create-profile
In general, the application is ready to be used without email configuration; for example when no smtp configuration is found you should be able to change the user email (in profile section) without the email validation step.
For more advanced setups, look a the Configuration section.