meshpotato/alpine-ssh-server repository overview

⁠Alpine-Edge SSH Server 🚀 Optimized for Cloud Containers

A high-performance, ready-to-use SSH server based on Alpine Edge. Specifically engineered to bypass the 100Mi ephemeral storage limits commonly found in cloud container environments by embedding all heavy dependencies directly into the image layers.

⁠🛠 Key Features

• Default Shell: fish (Friendly Interactive Shell) with a pre-configured prompt.
• Modern Terminal Tools:
  • eza: Modern ls replacement with file icons.
  • bat: A cat clone with syntax highlighting and Git integration.
  • fastfetch: Lightweight system information tool (runs automatically on login).
• Archive Utilities: Full support for zip, unzip, 7z (p7zip), rar, tar, gz, and bz2.
• Cloud Sync: rclone pre-installed for cloud storage management.
• Programming: Python 3 and Pip included for automation.
• Stability: Pre-resolved shared library dependencies (libgit2, libgcc, libstdc++) to prevent "symbol not found" errors.

⁠🚀 Quick Start (Deployment)

⁠1. Configuration Settings

⁠2. Environment Variables

To secure your server, set your SSH password via the Environment Variables tab in your dashboard.

⁠📂 Persistence Strategy

• While the tools are baked into the image, your data should reside on a persistent volume.

• This image expects a volume mounted at /config.

  • Fish Config: The shell configuration is symlinked to /config/.config/fish/config.fish.
  • Rclone Config: The default path is set to /config/rclone/config/rclone.conf.
  • Downloads/Data: Save all persistent files in the /config directory.

⁠⌨️ Included Aliases

Pre-configured for a premium terminal experience:

⁠🛠 Manual Build Instructions

If you wish to modify this image on your local machine (e.g., CachyOS/Arch), follow these steps:

1. Clone the repository:

   git clone https://github.com/yourusername/your-repo.git
   cd your-repo
   

   Copy

2. Build with Docker:

   docker build -t meshpotato/alpine-ssh-server:latest .
   

   Copy

3. Push to Docker Hub:

   docker push meshpotato/alpine-ssh-server:latest
   

   Copy

---

Maintained by: meshpotato
Built on: Alpine Edge