Before you begin
Currently you can't set a separate path for your footage. Therefore, please move the whole COPRA install folder to a drive / folder with enough free disk space. You will be able to change the server location at a later stage, though.
System Requirements
- Apple Macs with Apple Silicon are currently not supported
- latest version of COPRA onset server
- Docker environment
- operating system that's supported by Docker (Mac / Win / Linux / Unraid / Synology / etc.)
- active internet connection for the installation itself (after that you can use the server offline)
Installation
1) Download, Install and Start the Docker environment
> https://www.docker.com/get-started
Once it's running proceed to the next step.
2) Download, Install and Start the COPRA Server
Download & Unzip the file. In it you'll find a folder containing the server. Please move it to a location of your choice.
For installing & maintaining the Server you can either use the graphical user interface Kitematic or the terminal. This Tutorial uses the Terminal.
Navigate to the COPRA install folder by entering the following, then pressing Enter (note: exact location is different on your machine):
cd /Users/YourUserName/Desktop/copra_onset_server_20190930
Start the Server by entering:
docker-compose up
Note: This step takes a little bit longer the first time as required data is being downloaded.
At some point you should see something like the following in the terminal:
copra4 | Database Updated/Installed.
copra4 | Launching cron
copra4 | Launching FTP Server
copra4 | Launching apache
copra4 | AH00558: httpd: Could not reliably determine the server's fully qualified domain name, using 172.23.0.3. Set the 'ServerName' directive globally to suppress this message
Congratulations, the Server is already running!
3a) Accessing the Server (Web Browser)
Enter the (local) IP address of your machine in the web browser (for example 192.168.2.1) and press Enter. If switching between IP-addresses you can also use "localhost". You should now see the local COPRA server login window. For the login details please consult the installation directory.
Important: We strongly recommend changing the default login right away (under USER SETUP).
3b) Accessing the Server (iPhone / iPad)
To access your projects please create a non-admin user (for example a supervisor) and assign that user to a project or task. Go to the App Store and download the free app for iPhone or iPad. Within the app, go to Setup / SERVER SETUP. Disable the cloud server and enter a new local server:
host: your local IP-address
path: /
(Note: this is critical, regardless of where you've installed the server - only insert "/" here)
Now login with the non-admin user created above.
Using COPRA
Start by creating your first project (ADD on the upper right), then a task (for example DAILIES) and a reel (for example "Shooting Day 01"). Once inside a reel you can upload your footage, again - by clicking ADD in the upper right.
For more information please take a look at our Quickstart Guides, Encoding Recommendations and Metadata Tutorials for Systems like Resolve, Silverstack Lab or SCRATCH.
Further Reading
Server operation
Please be aware that using the steps above, the Server will be running while the Terminal window is open - once you quit it, the server will also shut down. If you want to run the Server in the background please use
docker-compose up -d
Other options for maintaining the server are
docker-compose stop
docker-compose start
docker-compose restart
For shutting down the server completely use
docker-compose down
Changing Ports
The server tries to set the following ports, please make sure that no other applications are using them:
80 - HTTP
7654 - HTTPS - (not working, but still configurable)
21 - FTP
30000-30009 - FTP Passive Mode
If you want to change those ports please use either the graphical user interface Kitematic (making sure to shut down the server completely after editing, then starting again) - or edit the hidden .env-file in the COPRA install folder. Using "Terminal" on a Mac as an example, here's one way of doing it:
open -a TextEdit .env
Changing the Server location
You can change the location of the Server by using either Kitematic or the Terminal to shut it down, then moving the install folder to the desired location. Here are the steps using the Terminal:
- stop the Server by pressing CTRL + C in the Terminal instance running the Server
- shut down the Server: docker-compose down
- move the COPRA installation folder to the new location (for example a different volume or even a different machine)
- start the server: docker-compose up