docs: CIP-2: Auth Providers

- Removed platform specific commands. Now things are platform independent
- Removed server verification with curl - no value
- The default way of running Chroma is via docker compose now

Refs: chroma-core/chroma#986

Author: tazarov

docs/usage-guide.md

@@ -735,97 +735,30 @@ Supported authentication methods:
 
 #### Server Setup
 
-
 ##### Generate Server-Side Credentials
 
 :::note Security Practices
 A good security practice is to store the password securely. In the example below we use bcrypt (currently the only supported hash in Chroma server side auth) to hash the plaintext password.
 :::
 
-**_Linux/MacOS:_**
-
-```bash
-export CHROMA_USER=admin
-export CHROMA_PASSWORD=admin
-docker run --rm --entrypoint htpasswd httpd:2 -Bbn ${CHROMA_USER} ${CHROMA_PASSWORD} > server.htpasswd
-```
-
-**_Windows:_**
-
-```bash
-set CHROMA_USER=admin
-set CHROMA_PASSWORD=admin
-
-docker run --rm --entrypoint htpasswd httpd:2 -Bbn %CHROMA_USER% %CHROMA_PASSWORD% > server.htpasswd
-```
-
-##### CLI
-
 ```bash
-CHROMA_SERVER_AUTH_CREDENTIALS_FILE="./server.htpasswd" \
-CHROMA_SERVER_AUTH_CREDENTIALS_PROVIDER='chromadb.auth.providers.HtpasswdFileServerAuthCredentialsProvider' \
-CHROMA_SERVER_AUTH_PROVIDER='chromadb.auth.basic.BasicAuthServerProvider' \
-uvicorn chromadb.app:app --workers 1 --host 0.0.0.0 --port 8000  --proxy-headers --log-config log_config.yml
+docker run --rm --entrypoint htpasswd httpd:2 -Bbn admin admin > server.htpasswd
 ```
 
-##### Docker
+##### Running the Server
 
-**_Linux/MacOS:_**
+Create a `.chroma_env` file with the following contents:
 
-```bash
-cat << EOF > .env
+```ini title=".chroma_env"
 CHROMA_SERVER_AUTH_CREDENTIALS_FILE="/chroma/server.htpasswd"
 CHROMA_SERVER_AUTH_CREDENTIALS_PROVIDER='chromadb.auth.providers.HtpasswdFileServerAuthCredentialsProvider'
 CHROMA_SERVER_AUTH_PROVIDER='chromadb.auth.basic.BasicAuthServerProvider'
-EOF
-
-docker-compose up -d --build
-```
-
-**_Windows:_**
-
-```bash
-echo CHROMA_SERVER_AUTH_CREDENTIALS_FILE="/chroma/server.htpasswd" > .env
-echo CHROMA_SERVER_AUTH_CREDENTIALS_PROVIDER='chromadb.auth.providers.HtpasswdFileServerAuthCredentialsProvider' >> .env
-echo CHROMA_SERVER_AUTH_PROVIDER='chromadb.auth.basic.BasicAuthServerProvider' >> .env
-
-docker-compose up -d --build
-```
-
-##### Verify the Server
-
-Now let's verify that the server is running and that authentication is working.
-
-**Success:**
-
-**_Linux/MacOS:_**
-
-```bash
-curl -v http://localhost:8000/api/v1/collections -u admin:admin
 ```
 
-**_Windows:_**
-
 ```bash
-$headers = @{ Authorization = 'Basic ' + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("admin:admin")) }
-Invoke-RestMethod -Uri 'http://localhost:8000/api/v1/collections' -Headers $headers -Verbose
+docker-compose --env-file ./.chroma_env up -d --build
 ```
 
-**Auth failure:**
-
-**_Linux/MacOS:_**
-
-```bash
-curl -v http://localhost:8000/api/v1/collections -u admin:admin1
-```
-
-**_Windows:_**
-
-```bash
-$headers = @{ Authorization = 'Basic ' + [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes("admin:admin1")) }
-Invoke-RestMethod -Uri 'http://localhost:8000/api/v1/collections' -Headers $headers -Verbose
-````
-
 #### Client Setup
 
 ```python