Project: Cone Server Setup Guide (v0.93.41)
π οΈ Project: Cone (PJCone) Server Setup Guide v0.93.41
PJCone is a self-hosted system where users manage their own data. This guide covers how to set up your server most securely and quickly using Docker-Compose.
1. Prerequisites
The following tools must be installed to run the server:
- Docker & Docker-Compose: Install the version for your OS from the Official Website.
- Git: Required for cloning the source code.
2. Quick Start
Using Docker-Compose allows you to complete the server configuration with a single command without complex environment setups.
STEP 1. Clone the Project
Open a terminal (or CMD) and enter the following commands in the folder where you want to download the server files:
1
2
git clone [https://github.com/is2you2/pjcone_server.git](https://github.com/is2you2/pjcone_server.git)
cd pjcone_server
STEP 2. Check Configuration (docker-compose.yml)
The provided docker-compose.yml file is already optimized. Open the file with a text editor to verify the data storage locations (Volumes) and access ports.
STEP 3. Run the Server
Enter the command below to build the necessary images and run the server in the background.
1
docker-compose up -d
After execution, you can check if the server is running via http://localhost:PORT_NUMBER.
3. Configuration Guide
Port Mapping
By default, the server operates within an internal network. To allow external access, Port Forwarding settings on your router are required.
- Host Port: The external port users will connect to (e.g., 8080).
- Container Port: The internal port used by the app.
Data Security & Backup (Volumes)
Volume Mapping is configured so that data is preserved even if the container is deleted.
./postgres:/var/lib/postgresql/data: Stores all issues, chats, and database records.- Important: Administrators can fully recover the server state by periodically backing up the DB data (
postgres) folder and the uploaded media (uploader/cdn) folder.
4. Key Tips for Beginners (Troubleshooting)
β Why use Docker-Compose?
It installs the necessary DB and runtime in an isolated virtual environment. This keeps your host PC clean and allows anyone to instantly set up a server with the exact same environment using a single configuration file.
β I want to check the server status.
To view the server logs in real-time:
1
docker-compose logs -f
β I want to stop or start the server.
- Start:
docker-compose up -d - Stop/Remove:
docker-compose down
5. Security Recommendations
- Internal Network Operation: For small teams, it is safest to operate within a VPN or a private network whenever possible.