Skip to content

Argentic / iOS app

Deploy Argentic / Déployer Argentic

English · Français · Privacy Policy · Support

English

One CloudFormation stack creates everything the app needs, in your own AWS account: the photos bucket, the search index, the sign-in identity pool and an AI cost alarm. You need an AWS account and about 5 minutes.

Before you start

Option A: AWS console, no terminal

  1. Download the template: argentic-stack.yaml.
  2. Open CloudFormation in your Region → Create stack → Upload a template file → select the file.
  3. Stack name: argentic. Optionally set AlarmEmail (recommended): AWS e-mails you if the AI assistant's usage ever runs away. Confirm the alert e-mail AWS sends you.
  4. Tick the IAM acknowledgement → Submit (about 3 minutes).
  5. Open the Outputs tab and copy ArgenticSetupCode.

Option B: CloudShell, in-browser terminal

Open CloudShell in your Region and paste:

curl -sL https://www.agiusalexandre.com/argentic/argentic-stack.yaml -o /tmp/argentic.yaml
aws cloudformation deploy --stack-name argentic \
  --template-file /tmp/argentic.yaml --capabilities CAPABILITY_IAM
aws cloudformation describe-stacks --stack-name argentic \
  --query "Stacks[0].Outputs[?OutputKey=='ArgenticSetupCode'].OutputValue" --output text

The last command prints the setup code.

Connect the app

  1. In Argentic: Connect your AWS → paste the setup code.
  2. Sign in with Apple. The first backup starts.

Family members install the app, paste the same setup code and sign in with their own Apple ID. Each gets an isolated space in your bucket: you pay the storage, and no one can open another member's photos (AWS IAM enforces it). Treat the setup code like a household invite.

Security note. Photos, thumbnails and settings are isolated by AWS IAM: a member can only read or delete their own. The search index is shared by the members of one deployment, and the app, not IAM, filters it per member. A member running a modified app could therefore read another member's search metadata (labels detected on the photos, recognized text, photo storage addresses), but never the photos themselves. Share the setup code only with people you trust.

Update an existing stack

Some app versions need a newer stack. Argentic 1.6 adds the Trash (Settings → Trash), which reads the copies your bucket keeps for 30 days after a delete. Stacks deployed before it do not allow that, and the app tells you so. The update only adds two read permissions and a clean-up rule: your photos, your setup code and your family members' spaces stay as they are.

  1. Download the latest template: argentic-stack.yaml.
  2. Open CloudFormation in your Region, select the argentic stack → Update → Make a direct update.
  3. Choose Replace existing template → Upload a template file → select the file → Next.
  4. Keep the parameters as they are → Next twice, tick the IAM acknowledgement → Submit.
  5. When the stack shows UPDATE_COMPLETE, open the Trash in the app again.

Cost and removal

Everything is billed to your AWS account. The app stores your photos in S3 Intelligent-Tiering, which moves those you do not open to cheaper tiers on its own (after 30, then 90 days). For a 50 GB library and one user, expect well under one dollar a month once that has happened (indicative, eu-west-1). If you delete the stack, the photos bucket is kept on purpose, so that no photo is lost by mistake; empty and delete it yourself if you want it gone.

Français

Une seule stack CloudFormation crée tout ce dont l'app a besoin, dans votre propre compte AWS : le bucket des photos, l'index de recherche, le groupe d'identités pour la connexion et une alarme de coût de l'IA. Il faut un compte AWS et environ 5 minutes.

Avant de commencer

  • Choisissez une de ces régions AWS, où la stack fonctionne : us-east-1, us-east-2, us-west-2, eu-west-1, eu-west-3, eu-central-1, eu-north-1, ap-northeast-1, ap-southeast-1, ap-southeast-2.
  • L'assistant et le récap du mois utilisent Claude Haiku 4.5 (Anthropic) par Amazon Bedrock. Anthropic demande une fois à chaque compte AWS de décrire son usage : dans la console Amazon Bedrock de votre région, ouvrez Claude Haiku 4.5 dans le catalogue de modèles, remplissez la description d'usage si elle vous est demandée, puis envoyez un message dans le playground. Cela active aussi le modèle dans votre compte. La sauvegarde et la recherche fonctionnent sans.

Option A : console AWS, sans terminal

  1. Téléchargez le modèle : argentic-stack.yaml.
  2. Ouvrez CloudFormation dans votre région → Create stack → Upload a template file → choisissez le fichier.
  3. Nom de la stack : argentic. Vous pouvez renseigner AlarmEmail (recommandé) : AWS vous écrit si l'usage de l'assistant s'emballe. Confirmez l'alerte dans l'e-mail qu'AWS vous envoie.
  4. Cochez la case d'accord IAM → Submit (environ 3 minutes).
  5. Ouvrez l'onglet Outputs et copiez ArgenticSetupCode.

Option B : CloudShell, le terminal dans le navigateur

Ouvrez CloudShell dans votre région et collez :

curl -sL https://www.agiusalexandre.com/argentic/argentic-stack.yaml -o /tmp/argentic.yaml
aws cloudformation deploy --stack-name argentic \
  --template-file /tmp/argentic.yaml --capabilities CAPABILITY_IAM
aws cloudformation describe-stacks --stack-name argentic \
  --query "Stacks[0].Outputs[?OutputKey=='ArgenticSetupCode'].OutputValue" --output text

La dernière commande affiche le code d'installation.

Connecter l'app

  1. Dans Argentic : Connect your AWS → collez le code d'installation.
  2. Connectez-vous avec Apple. La première sauvegarde démarre.

Les membres de la famille installent l'app, collent le même code et se connectent avec leur propre identifiant Apple. Chacun a un espace isolé dans votre bucket : vous payez le stockage, et personne ne peut ouvrir les photos d'un autre membre (AWS IAM l'impose). Traitez ce code comme une invitation au foyer.

Note de sécurité. Photos, miniatures et réglages sont isolés par AWS IAM : un membre ne peut lire ou supprimer que les siens. L'index de recherche est partagé par les membres d'un même déploiement, et c'est l'app, pas IAM, qui le filtre par membre. Un membre qui utiliserait une app modifiée pourrait donc lire les métadonnées de recherche d'un autre membre (étiquettes détectées sur les photos, texte reconnu, adresses de stockage des photos), mais jamais les photos elles-mêmes. Ne partagez le code qu'avec des personnes de confiance.

Mettre à jour une stack existante

Certaines versions de l'app demandent une stack plus récente. Argentic 1.6 ajoute la Corbeille (Réglages → Corbeille), qui lit les copies que votre bucket garde 30 jours après une suppression. Les stacks déployées avant ne le permettent pas, et l'app vous le dit. La mise à jour ajoute seulement deux droits de lecture et une règle de nettoyage : vos photos, votre code d'installation et les espaces des membres de la famille restent tels quels.

  1. Téléchargez le modèle le plus récent : argentic-stack.yaml.
  2. Ouvrez CloudFormation dans votre région, sélectionnez la stack argentic → Update → Make a direct update.
  3. Choisissez Replace existing template → Upload a template file → choisissez le fichier → Next.
  4. Gardez les paramètres tels quels → Next deux fois, cochez la case d'accord IAM → Submit.
  5. Quand la stack affiche UPDATE_COMPLETE, rouvrez la Corbeille dans l'app.

Coût et suppression

Tout est facturé sur votre compte AWS. L'app range vos photos en S3 Intelligent-Tiering, qui place de lui-même celles que vous n'ouvrez pas dans des niveaux moins chers (après 30, puis 90 jours). Pour une photothèque de 50 Go et un utilisateur, comptez ensuite bien moins d'un dollar par mois (indicatif, eu-west-1). Si vous supprimez la stack, le bucket des photos est gardé exprès, pour qu'aucune photo ne se perde par erreur : videz-le et supprimez-le vous-même si vous n'en voulez plus.