ConfigHub Support

ConfigHub (参数管家) is an iOS / iPadOS tool for maintaining remote server configuration over time. The app primarily uses the SSH (Secure Shell) protocol to talk to Linux / Unix servers you designate: browse remote directories, read and save config files (YAML, JSON, .env, and more), with tree editing, raw text mode, and an optional version timeline on device.

How the app works (SSH)

We do not run our own cloud servers that host your configuration content. A typical workflow:

Enable SSH on your server and ensure your iPhone or iPad can reach the host and port (default 22).
Create a project in ConfigHub with host, port, username, and your SSH password (stored in the system Keychain).
The app opens an encrypted SSH session and uses SFTP-style operations to list folders, download files for editing, and upload changes when you save.
Optionally sync project structure, version snapshots, and parameter notes via Apple iCloud across your devices (see our Privacy Policy).

Authentication (current version): ConfigHub supports SSH password authentication only. Private keys and certificates cannot be imported or pasted. If the server disables password login (key-only), the app cannot connect—you must enable password login for that user on the server (see section 5 below), or wait for a future release with key support.

Security: Passwords are stored in the iOS Keychain. Saving writes directly to the remote server—verify paths and permissions first. Use a strong SSH password and disable direct root login where possible.

Enable SSH on Ubuntu

These steps target common Ubuntu Server 22.04 / 24.04 installs. Cloud providers (AWS, GCP, Azure, etc.) also require their security group / firewall to allow your SSH port from the networks you use.

1. Install the OpenSSH server

On the server (console or existing shell):

sudo apt update
sudo apt install -y openssh-server

2. Start and enable the service

sudo systemctl enable ssh
sudo systemctl start ssh
sudo systemctl status ssh

Look for active (running). On some images the unit is named ssh or sshd—use whichever systemctl status reports.

3. Open the firewall (if UFW is enabled)

sudo ufw allow OpenSSH
# or: sudo ufw allow 22/tcp
sudo ufw enable
sudo ufw status

4. Confirm the listening port and address

ss -tlnp | grep ssh
hostname -I

In ConfigHub, enter:

Host: public IP, DNS name, or LAN IP if you are on the same network
Port: 22 unless you changed Port in /etc/ssh/sshd_config
Username: e.g. ubuntu (common on AWS), root, or a user you created

5. Allow password login (required by the app)

ConfigHub connects with username + password. Ensure sshd has not disabled password authentication. Edit (path may vary): /etc/ssh/sshd_config

PasswordAuthentication yes
# If present and set to no, change to yes:
# KbdInteractiveAuthentication yes

Reload the service:

sudo systemctl reload ssh

Set a login password for the Linux user if needed:

sudo passwd your_username

Test from a Mac terminal (same method as the app):

ssh -p 22 user@your-server

Note: You can still use SSH keys from a terminal on your computer; the app does not read private key files in the current version. Some cloud images are key-only by default—set an instance password or enable password authentication per your provider’s docs before saving the connection in ConfigHub.

6. Other platforms (brief)

Debian: same as Ubuntu—package openssh-server.
CentOS / RHEL / Rocky: sudo dnf install -y openssh-server && sudo systemctl enable --now sshd, then allow the ssh service in firewalld.
macOS Remote Login: System Settings → General → Sharing → Remote Login. ConfigHub connects over SSH the same way.

Add a connection in the app

Open ConfigHub → create or open a project.
Set SSH: host, port, username, and password (saved to the Keychain).
Use remote browse to pick a config file on the server, or enter the path manually.
Save writes back over SSH. Try demo mode first to learn the UI without touching production servers.

Contact us

Email: zhangxiaouse@163.com
In the app: Settings → Support → Send feedback (include iOS version and a short SSH error summary—do not email your server password)

Developer WeChat QR code — Scan with WeChat to contact the developer

Common questions

SSH connection fails — Verify host, port, username, and password; confirm the server allows password login (section 5). The app does not support private keys—key-only servers cannot be used until a future update. Check security groups, that sshd is running, and network reachability. Jump hosts are not built in; use VPN or port forwarding if needed.
Connection times out — Usually firewall or routing; a private LAN IP will not work over cellular without VPN.
Permission denied — Usually wrong password or password auth disabled. Test with ssh user@host in Terminal. For pubkey-only servers, set PasswordAuthentication yes in sshd_config and set a user password.
Save fails — Confirm write permission (ls -l), disk space, and that the path is a file not a directory.
iCloud sync — Sign in to iCloud on the device, enable sync in app Settings; some features require ConfigHub Pro.
Subscriptions — Manage or cancel in iOS Settings → Apple ID → Subscriptions. Use Restore Purchases on the membership screen after reinstalling.
Passcode / Face ID — Enable under Settings → Security. Permission prompts follow your device language.

Legal

Other languages: 中文支持页面