FAQ
How to change the port?
The self-hosted version of SwanLab is deployed based on Docker. By default, it uses port 8000
. Modifying the default access port of the self-hosted service actually means modifying the mapping port of the swanlab-traefik container. There are two scenarios:
Modifying before deployment
The installation script provides some configuration options, including data storage location and mapped port. We can modify the port by changing the script startup parameters.
- After executing the
install.sh
installation script, the command line will prompt for configuration options, where you can enter the corresponding parameters interactively. When the command line outputs2. Use the default port (8000)? (y/n):
, entern
, and then you will be prompted withEnter a custom port:
. Enter the desired port number, for example,80
.
❯ bash install.sh
🤩 Docker is installed, so let's get started.
🧐 Checking if Docker is running...
1. Use the default path (./data)? (y/n):
The selected path is: ./data
2. Use the default port (8000)? (y/n):
- Add parameters when running the script. The installation script provides a command-line parameter
-p
that can be used to modify the port, for example:./install.sh -p 80
.
For more command-line parameters, see: Deploy via Docker
Modifying after deployment
If you need to modify the access port after the SwanLab service has been deployed, you need to modify the generated docker-compose.yaml
configuration file.
Find the swanlab/
directory at the location where the script was executed, run cd swanlab/
to enter the swanlab
directory, locate the corresponding docker-compose.yaml
configuration file, and then modify the port ports
for the traefik
container as shown below:
traefik:
<<: *common
image: ccr.ccs.tencentyun.com/self-hosted/traefik:v3.0
container_name: swanlab-traefik
ports:
- "8000:80"
- "80:80"
The above changes the access port to
80
After making the changes, execute docker compose up -d
to restart the container. Once restarted, you can access it via http://{ip}:80
What to Do When Uploading Media Files Results in an Error
When you use swanlab.log
to record media files (such as images or audio) and encounter an error like:
swanlab: Upload error: An error occurred (InvalidAccessKeyId) when calling the PutObject operation: The Access Key Id you provided does not exist in our records.
Please check whether your server has port 9000 open. If it is not open, configure your server's firewall/security group to allow traffic on port 9000.