# Run Wildland client from a Docker image (recommended)
# Install Docker
Using the Homebrew package manager (if you don't have Homebrew, install it following the steps described on their home page (opens new window)):
% brew install --cask docker
Launch the Docker.app and let it finish the installation.
# Clone Wildland repository
% git clone -b stable https://gitlab.com/wildland/wildland-client.git
# Build and start Docker image
% cd wildland-client/docker % docker-compose build % docker-compose run --service-ports wildland-client
This will start the Wildland terminal session through which you can
interact with Wildland client using the
To connect to the Wildland filesystem using Finder, select Connect to Server from Go menu and type
the server address. If you get a warning about an insecure connection, just choose to connect and select "Connect as Guest" when asked
for a password.
Once you have completed all of these steps, head over to the Quick Start Guide and follow the instructions there.
# Run Wildland macOS client
Wildland macOS client is under active development and has not received a lot of testing yet. Use it only if you are prepared to encounter some bugs, and willing to risk losing your data. Also, do not expect any real GUI frontend. Currently the only way to interact with Wildland is through the command line interface.
Clone the macOS client from the project's GitLab repository (opens new window):
% git clone https://gitlab.com/wildland/wildland-client-macos.git
First of all, make sure that you checked out all the dependencies in source form:
git submodule update --init
and in binary form:
brew install signify-osx autoconf autogen automake
This project currently uses the following dependencies:
- Python: cpython 3.9.2
- OpenSSL: 1.1.1i
- xz: 5.2.5
- wildland-client: closely tracking project HEAD
- signify: latest stable version available from HomeBrew
The Xcode project is currently configured to embed all the above-mentioned dependencies into the application bundle.
Python and OpenSSL are built from source, which means that:
- fresh build can take some time,
- if you encounter any problems, the first thing to do is to clean the build directory.
Building using Xcode should be straightforward: just open WildandClient xcode project, make sure that WildlandClient target is selected and press Cmd+B.
Building from the command line:
cd WildlandClient xcodebuild -scheme WildlandClient OBJROOT=/tmp/wl-build SYMROOT=/tmp/wl-products
should build the project and put the resulting artifacts in
# First launch
Copy WildlandClient.app to your /Applications folder.
You start the client by opening WildlandClient.app. This installs the daemon which will create the mount point for Wildland. The daemon will launch automatically once you log in.
Wildland's command line interface is available at:
See Quick Start Guide for more.