SoulTrade Software
Not very technical?
Use the Easy Install (Docker) tab -- a double-click installer that sets everything up automatically. No databases, no server configuration.
The Easy Install version uses Docker to set up everything automatically. No technical knowledge required.
Our Docker easy installs fetch the latest PHP security release when you first install
Download and install Docker Desktop from docker.com/products/docker-desktop -- it's free. Start it and wait until it shows Running in your Mac's menu bar, or on Windows until its window shows the Containers page. (On Windows, choose All-users installation with WSL 2 when Docker's installer asks; the Windows guide has screenshots.)
.app, choose Open, then click Open again in the dialog that appears.
Double-click the installer .app (Mac). When macOS asks "would like to access your [folder name]" -- click Allow. This just lets the installer put the software in the folder you choose.
Choose your install location when prompted -- Downloads, Documents, or anywhere you like. The installer handles everything else automatically.
Windows: right-click the zip and choose Extract All, open the extracted folder, and double-click Install [product name]. If Windows warns that the publisher could not be verified, click Run. Type 1 and press Enter, then choose where to install (Documents is fine). Windows guide with screenshots →
Default login: username admin password changeme. Change your password immediately in Setup → Password.
After installation, open Docker Desktop and you'll see your software listed with Start and Stop buttons. You can start and stop from there at any time.(or just quit Docker to stop)
Open Docker Desktop and click Start next to your product — this is the easiest method on any platform.
Or double-click start.command in your install folder — this starts the container and opens your browser automatically.
Or double-click start.bat in your install folder.
Once the container is running, go to:
http://localhost:8080/cspracticehttp://localhost:8081/soletraderhttp://localhost:8082/praxisUse the Stop button in Docker Desktop, double-click stop.command (Mac), or simply quit Docker Desktop.
The complete README covering Mac, Windows, login details, data storage and updating is available at: easy_install_readme.txt
The Docker zip works directly on any Linux-based NAS or server. No Mac or Windows installer needed.
Once set up, start and stop the software directly from Container Manager in your Synology browser interface -- no command line needed after initial setup.
docker-compose.yml in the unzipped folderhttp://[NAS-IP]:8080/cspracticecurl -fsSL https://get.docker.com | shdocker compose up -d from the install folderhttp://[server-IP]:8080/cspracticestart.command and start.bat scripts are Mac/Windows only.
On Linux just use docker compose up -d and docker compose down.
Your records are stored in a Docker volume on your computer and persist between restarts. Your settings (config.php) and attachments are in the install folder. Back up regularly using Setup → Backup.
Mac: unzip the new download, double-click the new Installer.app and choose the same place as before (the folder that contains your installed copy, usually Documents). When it says your product is already installed there, click Overwrite. Your records, settings and attachments are kept.
Windows: extract the new download, double-click Install [product name] and choose 3. Update to this version. When it asks, choose the folder that contains your installed copy (usually Documents). Your records, settings and attachments are kept.
Linux & NAS: see the update steps in the Linux guide on the machine-specific install guides page.
To update files only: replace files directly in the app/ subfolder of your install folder. Changes take effect immediately — no Docker restart needed. Don't replace config.php: it holds your settings, database details and encryption key.
The standard version requires a PHP/MySQL server. The most common setup on a Mac or PC is MAMP.
Full product-specific installation guides:
crystalsolutions), with collation utf8mb4_unicode_cihtdocs folder, copying the whole folder in one go so the hidden .htaccess files come too:/Applications/MAMP/htdocs/cspracticeC:\MAMP\htdocs\cspracticehttp://localhost:8888/cspractice/cs_install.php on a Mac (SoleTrader: st_install.php, PraxisClinic: praxis_install.php). It sets up the database and config.php for you. Use host localhost, username root, password root (MAMP's defaults), and choose your own admin username and password.Prefer XAMPP on Windows? See the Windows guide.
public_html/cspractice), including the hidden .htaccess fileshttps://yourdomain.com/cspractice/cs_install.php, and enter the database details from your hosting panel. It creates the tables and config.php for you.https://yourdomain.com/cspractice) and log incspracticepraxissoletraderThese match the BASE_URL already set in config.php. If you use a different folder name, update BASE_URL to match.
Standard install (MAMP/XAMPP/hosting):
You choose your own admin username and password (at least 6 characters) in the web installer. Write them down.
Easy Install (Docker):
Username: admin Password: changeme
For the Easy Install, change the password immediately in Setup → Password.
Without a licence the software runs in trial mode -- up to 10 patients/clients. All features are available in trial mode.
The MTD module for direct HMRC quarterly submissions is built in. Go to Setup → MTD / HMRC to connect your HMRC account. You'll need your own HMRC developer credentials -- see the in-software help for full instructions.
Yes -- the software is designed for intranet use. Multiple users can connect from different computers on the same network by pointing their browsers at the server's IP address.
All data is stored on your own computer or server -- it never leaves your machine. There is no cloud storage or third-party access. Back up regularly using Setup → Backup.
Yes -- use Setup → Backup to create a backup, install the software on the new machine, then restore the backup there. This works for every kind of install.
For the Easy Install (Docker), copying the install folder on its own does not move your records: they're kept in Docker's own database storage, not in the folder. Use Backup and restore.
Check that your web server (MAMP or Docker) is running. Check that the database credentials in config.php are correct. Check that all SQL files were run in order.
Update the password directly in the database via phpMyAdmin -- find your user in the users table and update the password field with a new SHA-256 hash. Or email jol@soul-trade.com for help.
Yes -- install on one machine as the server, then access from other machines on the same network via the server's IP address in a browser.
CrystalSolutions install guide
PraxisClinic install guide
SoleTrader install guide
Easy install guides
Machine & product specific install guides (Mac, Windows, Linux, NAS)
Email: jol@soul-trade.com
Forum: soul-trade.com/CSForum/