1Panel Panel Deployment

This document provides a graphical tutorial for deploying Lamafa using the 1Panel panel.

Prerequisites

Step 1: Install 1Panel Panel

Step 2: Install Lamafa

Search for Applications

Configure Parameters

• Name: The name of the Lamafa application to be created
• Version: Select the version of Lamafa
• Port: The service port for the Lamafa application
• Timezone: Enter the timezone where the server is located (default Asia/Shanghai)
• Advanced Settings: Be sure to check external port access

Confirm Installation

Step 3: Configure Environment Variables (Important)

After installation, it is recommended to configure the following key environment variables:

Required Environment Variables

Configuration Method

1. In the 1Panel application list, click the Parameters button for the Lamafa application
2. Add in the environment variables section:
   • SESSION_SECRET=your_random_secret_key
   • CRYPTO_SECRET=your_crypto_secret_key (optional)
3. Click Confirm to save the configuration
4. Restart the application for the configuration to take effect

Generate Random Secrets

# Generate SESSION_SECRET
openssl rand -hex 16

# Or use Linux command
head -c 16 /dev/urandom | xxd -p

Step 4: Access Lamafa

The first visit will automatically guide you to the initialization page. Follow the on-screen instructions to set up an administrator account and password.

Common Issues

Cannot access application interface

1. Check if the application status is "Started"
2. Confirm that the port is correctly mapped and open
3. Check the server firewall and cloud server security group

Session invalid after login

Ensure the SESSION_SECRET environment variable is set and not empty.

How to update version

1. Log in to 1Panel panel, go to App Store → Upgradable page
2. Find the Lamafa application, click the Upgrade button
3. Select the target version, click Confirm

How to persist data

1Panel applications store data in Docker volumes by default. To customize storage location:

1. In the application parameter settings, configure directory mapping
2. Ensure the /data directory is mapped to persistent storage

Related Links

• Environment Variables Configuration
• Docker Compose Deployment
• FAQ