For OSX (macOS) Catalina or Big Sur on Intel (i5/i7) the tested version is: 4.0.1(68347). You may go newer of course.
For Big Sur and Apple Silicon M1 Chips please read https://docs.docker.com/docker-for-mac/apple-silicon/. You may need to enable manual compatibility mode in your docker-compose.yml file for the esmero-php and esmero-cantaloupe containers.
In Preferences-> General: check Use gRPC FUSE for file sharing and restart. Specially if you are using your $HOME folder for deploying, e.g. /Users/username.
In Preferences-> Resources: 4 Gbytes of RAM is the recommended minimun and works; 8 Gbytes is faster and snappier.
At least 10 Gbytes of free space (to get started).
Being able to open a terminal.
Start - follow commands:
Open a terminal: follow this command if you want to remove old docker.
docker-compose down
docker-compose rm
Step 1 (M1): Docker Deployment on Apple Silicon Chips (M1)
In your location of choice clone this repo:
cd
cd /Users/tod/Projects
git clone https://github.com/esmero/archipelago-deployment.git archipelago-deployment
cd archipelago-deployment
git checkout 1.0.0
cp docker-compose-arm64.yml docker-compose.yml
docker-compose pull
docker-compose up -d
Step 2: Set up your Minio S3 bucket
Access the minio console at http://:9001 with the following credentials:
user:minio
pass:minio123
Once logged in, press on "Buckets" (left tools column) and then on "Create Bucket" (top right) and under "Bucket Name" type archipelago.
Step 3: Deploy Drupal 9 and the awesome Archipelago Modules
cd
cd /Users/tod/Projects/archipelago-deployment
docker exec -ti esmero-php bash -c "composer install"
Archipelago documentation Reference: https://docs.archipelago.nyc/1.0.0/archipelago-deployment-osx/
Pre-requisites:
Catalina
orBig Sur
on Intel (i5/i7) the tested version is: 4.0.1(68347). You may go newer of course.Big Sur
andApple Silicon M1
Chips please read https://docs.docker.com/docker-for-mac/apple-silicon/. You may need to enable manual compatibility mode in yourdocker-compose.yml
file for theesmero-php
andesmero-cantaloupe
containers.Preferences
->General
: checkUse gRPC FUSE for file sharing
and restart. Specially if you are using your $HOME folder for deploying, e.g./Users/username
.Preferences
->Resources
: 4 Gbytes of RAM is the recommended minimun and works; 8 Gbytes is faster and snappier.Start - follow commands:
Open a terminal: follow this command if you want to remove old docker.
Step 1 (M1): Docker Deployment on Apple Silicon Chips (M1)
Access the minio console at http://:9001 with the following credentials:
Once logged in, press on "Buckets" (left tools column) and then on "Create Bucket" (top right) and under "Bucket Name" type archipelago.
Once that command finishes run our setup script:
Deploy Drupal using the provided Configurations run:
Archipelago has been deployed locally in your mac - yay!
Now, to add basic setup and configure few settings
<local_ip>:8001/admin/config/archipelago/iiif
Change
Base URL of your IIIF Media Server public accessible from the Outside World.
tohttp://<local_ip>:8183/iiif/2
<local_ip>:8001admin/config/media/s3fs
public
in Public folder.settings.php
:Press
Page down
and go the end of the file. Find$settings...s3 type commands.
There, enter one line below this
$settings...s3 type commands
.Copy these 2 commands and paste there:
Press
Ctrl+X
to save & pressY
.Go to
<local_ip>:8001admin/config/media/s3fs/actions
, PressValidate
&Refresh File Metadata cache
.Go to modules and install
Admin Toolbar Extra Tools
andAdmin Toolbar Search
module.All Basic Setup added for local deployment!