Open Brand Exchangev0.1Versjon 0.1. Versjon 0.1 er utgitt. Spesifikasjonen og programvaren er fri å bruke.
Hosting
Kjør den der du vil. Betal bare for hosting.
Én portal er ett merkevareselskap på én server. Du velger hvordan den driftes, fra helt satt bort til helt selv. Nedenfor fra det enkleste til det mest tekniske.
Det enkleste: et selskap drifter portalen din, holder den oppdatert og hjelper deg med oppsettet. Fordi alle portaler snakker samme standard, kan du senere bytte til en annen leverandør eller til egen hosting.
Photopilot
Product photography software for fashion and lifestyle. Hosts a brand portal on your own domain and publishes through OBX.
Alle hostingselskaper, byråer og programvareleverandører kan stå her. Vilkårene er like for alle:
portalen din består samsvarstestene
en merkevare kan eksportere alle data og bilder og forlate deg
du oppgir dine egne priser og vilkår på ditt eget nettsted
Åpne en pull request i nettstedets repository med opplysningene dine i src/data/providers.json. Leverandørene står i alfabetisk rekkefølge. openbrandexchange/website
2. Med ett klikk
Din egen portal på din egen konto, uten å drifte en server.
Portal for Cloudflare
Kjører på Cloudflare Workers, med D1 som database og R2 for bildene. Klikk på knappen, logg inn hos Cloudflare og følg trinnene. En portal i daglig bruk trenger abonnementet Workers Paid (5 dollar i måneden); gratisabonnementet holder bare til å se seg om. Nettversjoner av bildene deres lages av nettleseren og verktøyet obx.
Et skript som setter portalen din opp på Google Cloud Run. Du trenger en Google Cloud-konto og gcloud-verktøyet.
git clone https://github.com/openbrandexchange/node-go
cd node-go
gcloud config set project my-project # once: your Google Cloud project (billing on)
DRY_RUN=1 ./deploy/cloudrun.sh # optional: only show what it would do, change nothing
./deploy/cloudrun.sh # region europe-west4; REGION=… for another
For webhotellet du kanskje allerede har, med PHP og en database. Ingen kommandoer nødvendig:
Last ned obx-portal-php-<version>.zip fra den nyeste utgivelsen.
Pakk den ut og last opp mappen til webhotellet med (S)FTP.
Pek (under)domenet ditt, for eksempel forhandler.dittmerke.no, mot mappen public.
Gjør mappene data og config skrivbare (tillatelser 775; sier installasjonen fortsatt at de ikke er det, 777).
Åpne adressen. Installasjonen sjekker serveren og ber om oppsettskoden fra filen data/SETUP-CODE.txt, som du åpner med FTP-programmet. Klikk deretter på “Åpne oppsettsveiviseren”.
Legg inn cron-adressen installasjonen viser som en cron-jobb i webhotellets kontrollpanel, hvert 5. minutt. Portalen virker også uten.
På din egen server eller i en hvilken som helst sky som kjører containere. Én kommando:
openssl rand -hex 32 > obx-secret.key # once; keep this file safe, with your backups
docker run -d --name obx --restart unless-stopped \
-p 8080:8080 -v obx-data:/data \
-e OBX_PUBLIC_URL=https://brands.example.com \
-e OBX_SECRET_KEY="$(cat obx-secret.key)" \
ghcr.io/openbrandexchange/node-go
docker logs obx 2>&1 | grep -i "setup code" # the one-time code for the first-run wizard
Eller med HTTPS innebygd, via Caddy:
compose.yaml
# compose.yaml: the node behind Caddy, which gets an HTTPS certificate by itself.
services:
obx:
image: ghcr.io/openbrandexchange/node-go
restart: unless-stopped
environment:
OBX_PUBLIC_URL: https://brands.example.com
OBX_SECRET_KEY: ${OBX_SECRET_KEY} # openssl rand -hex 32, keep it safe
OBX_TRUST_PROXY: "true" # every request comes through Caddy (rate limits per visitor)
volumes:
- obx-data:/data
caddy:
image: caddy:2
restart: unless-stopped
ports: ["80:80", "443:443"]
command: caddy reverse-proxy --from brands.example.com --to obx:8080
volumes:
- caddy-data:/data
volumes:
obx-data:
caddy-data:
Innstillinger
OBX_PUBLIC_URL
den offentlige adressen til portalen din
OBX_SECRET_KEY
en lang tilfeldig nøkkel (openssl rand -hex 32); ta godt vare på den
OBX_SETUP_CODE
valgfritt: en oppsettkode du velger på forhånd
PORT
port, 8080 som standard
Etter installasjonen: første oppstart
Åpne adressen til portalen din i nettleseren.
Skriv inn engangskoden for oppsett. Den står i loggen ved første oppstart (Portal for webhotell: i data/SETUP-CODE.txt, og installasjonen fyller den inn for deg), eller du angir den på forhånd med OBX_SETUP_CODE.
Fyll inn selskapet og den første merkevaren din, og velg ditt eget passord. Det finnes aldri et standardpassord.
Oppsettkoden sørger for at ingen andre kan ta over en nyinstallert portal.
Ditt eget domene
Bruk et underdomene som forhandler.dittmerke.no eller b2b.dittmerke.no. Forhandlerne ser da navnet ditt, og adressen er den samme hvis du bytter hosting.
Tre utgaver, én portal
De tre utgavene gjør det samme og har samme administrasjon og samme forhandlerportal. Velg det som passer hostingen din; du kan bytte senere. Se implementasjonene.